home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / I18N::Collate.Z / I18N::Collate
Encoding:
Text File  |  1998-10-28  |  3.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222)))) IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       I18N::Collate    - compare 8-bit    scalar data according to the
  10.       current locale
  11.  
  12.         ***
  13.  
  14.         WARNING: starting from the Perl version 5.003_06
  15.         the    I18N::Collate interface    for comparing 8-bit scalar data
  16.         according to the current locale
  17.  
  18.           HAS BEEN DEPRECATED
  19.  
  20.         That is, please do not use it anymore for any new applications
  21.         and    please migrate the old applications away from it because its
  22.         functionality was integrated into the Perl core language in    the
  23.         release 5.003_06.
  24.  
  25.         See    the perllocale manual page for further information.
  26.  
  27.         ***
  28.  
  29.  
  30.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  31.           use I18N::Collate;
  32.           setlocale(LC_COLLATE, 'locale-of-your-choice');
  33.           $s1 = new    I18N::Collate "scalar_data_1";
  34.           $s2 = new    I18N::Collate "scalar_data_2";
  35.  
  36.  
  37.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.       This module provides you with    objects    that will collate
  39.       according to your national character set, provided that the
  40.       POSIX    _s_e_t_l_o_c_a_l_e() function is    supported on your system.
  41.  
  42.       You can compare $s1 and $s2 above with
  43.  
  44.           $s1 le $s2
  45.  
  46.       to extract the data itself, you'll need a dereference: $$s1
  47.  
  48.       This module uses _P_O_S_I_X::_s_e_t_l_o_c_a_l_e(). The basic collation
  49.       conversion is    done by    _s_t_r_x_f_r_m() which    terminates at NUL
  50.       characters being a decent C routine.    _c_o_l_l_a_t_e__x_f_r_m() handles
  51.       embedded NUL characters gracefully.
  52.  
  53.       The available    locales    depend on your operating system; try
  54.       whether locale -a shows them or man pages for    "locale" or
  55.       "nlsinfo" or the direct approach ls /usr/lib/nls/loc or ls
  56.       /usr/lib/nls or ls /usr/lib/locale.  Not all the locales
  57.       that your vendor supports are    necessarily installed: please
  58.       consult your operating system's documentation    and possibly
  59.       your local system administration.  The locale    names are
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222)))) IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))
  71.  
  72.  
  73.  
  74.       probably something like xx_XX.(ISO)?8859-N or
  75.       xx_XX.(ISO)?8859N, for example fr_CH.ISO8859-1 is the    Swiss
  76.       (CH) variant of French (fr), ISO Latin (8859)    1 (-1) which
  77.       is the Western European character set.
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.